newButton

Type

message

Summary

Sent to a new button right after it's created.

Syntax

newButton

Description

Handle the newButton message if you want to create additional objects, switch tools, or do other tasks when a new button is created.

Normally, the newButton message is handled at a higher level of the message path, since the newly created button does not yet have a script unless the templateButton contains one.

The actual creation is not triggered by the newButton message, so trapping the message and not allowing it to pass does not prevent the button from being created.

Examples

on newButton -- put new buttons at a random location
  set the location of the target to \
  random(the width of this stack - the width of the target div 2), \
  random(the height of this stack - the height of the target div 2)
end newButton

Related

glossary: object, trap, message, tool, message path

keyword: templateButton

object: button

property: script

command: copy, clone, paste

control structure: pass

Compatibility and Support

Introduced

LiveCode 1.0

OS

mac

windows

linux

ios

android

Platforms

desktop

server

mobile